// Ionic Starter App     starter模块

// angular.module is a global place for creating, registering（记录） and retrieving （索取）Angular modules   
// 'starter' is the name of this angular module example (also set in a <body> attribute（属性） in index.html)
// the 2nd（需要2个） parameter（参数） is an array of 'requires'
// 'starter.services' is found in services.js
// 'starter.controllers' is found in controllers.js

// 定义一个模块，这个模块需要依赖两个 模块
angular.module('starter', ['ionic', 'starter.controllers', 'starter.services'])
// .run()块中设置路由事件的监听器以及过滤未经授权的请求，该函数接收一个参数

//  run() 是所有angular 应用中第一个被执行的方法
.run(function($ionicPlatform) {
//一个Angular 抽象的ionic.platform,用于检测当前的平台： 是ios 的还是 android
//以及诸如在PhoneGap/Cordova 中覆盖Android 后退按钮
// 一旦设备就绪，则触发一个回调函数，或如果该设备已经就绪，则立即调用
  $ionicPlatform.ready(function() {
    // Hide the accessory（附件） bar（条） by default (remove this to show the accessory bar above the keyboard （键盘）  
    // for form inputs)
    if (window.cordova && window.cordova.plugins && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
      cordova.plugins.Keyboard.disableScroll(true);

    }
    if (window.StatusBar) {
      // org.apache.cordova.statusbar required
      StatusBar.styleDefault();
    }
  });
})

// 对模块进行配置
// 配置$routeProvider 用来定义路由规则

// $stateProvider 路由控制
// 路由重定向 $urlRouterProvider

//  $stateProvider  配置路由状态
.config(function($stateProvider, $urlRouterProvider) {

  // Ionic uses AngularUI Router which uses the concept of states
  // Learn more here: https://github.com/angular-ui/ui-router
  // Set up the various states which the app can be in.
  // Each state's controller can be found in controllers.js
  $stateProvider

  // setup an abstract state for the tabs directive
    .state('tab', {
    url: '/tab',
    abstract: true,
    templateUrl: 'templates/tabs.html' // 模板的url  www目录下templates 是模板目录，完整的路径
  })

  // Each tab has its own nav history stack:

  .state('tab.dash', {
    url: '/dash',
    //  views  用于某个状态下有多个ui-view 的情况
    //  此时可对不同的ui-view  使用特定的template
    //  如果url 是 /dash 的话，用 templates/tab-dash.html 渲染视图
    //  指定控制器的名称
    views: {
      'tab-dash': {
        templateUrl: 'templates/tab-dash.html',
        controller: 'DashCtrl'
      }
    }
  })

  .state('tab.chats', {
      url: '/chats',
      views: {
        'tab-chats': {
          templateUrl: 'templates/tab-chats.html',
          controller: 'ChatsCtrl'
        }
      }
    })
    .state('tab.chat-detail', {
      url: '/chats/:chatId',
      views: {
        'tab-chats': {
          templateUrl: 'templates/chat-detail.html',
          controller: 'ChatDetailCtrl'
        }
      }
    })

  .state('tab.account', {
    url: '/account',
    views: {
      'tab-account': {
        templateUrl: 'templates/tab-account.html',
        controller: 'AccountCtrl'
      }
    }
  });

  //  $urlRouterProvider 可以设置默认的路由，它负责处理在状态配置中指定的url路由方式之外的url请求的路由方式

  // if none of the above states are matched, use this as the fallback
  $urlRouterProvider.otherwise('/tab/dash');

});
